home *** CD-ROM | disk | FTP | other *** search
/ Macwelt 4 / Macwelt DVD 4.cdr / Entwickler / Mac-OS / 24uSimpleDialogPlug-In / 24uSimpleDialogTutorial.fp3 (.txt) < prev    next >
Encoding:
FileMaker Pro Database  |  2002-09-05  |  91.6 KB  |  653 lines  |  [FMP3/FMP3]
  1. 24uSimpleDialogTutorial.fp3
  2. FMP3FMP3
  3.  Copyright 1984-1998 FileMaker, Inc. 
  4. HBAM2016AUG95
  5. Pro 3.0
  6. VLSTSTATEDESC
  7. HBAM3016AUG95@
  8. buttonD
  9. checkbox
  10. fieldA
  11. menuE
  12. passwordB
  13. password
  14. fieldB
  15. pop-upE
  16. pop-up
  17. menuE
  18. radioD
  19. radio
  20. buttonD
  21. textA
  22. fieldA
  23. checked
  24. mixed
  25. unchecked
  26. cardA
  27. creditA
  28. credit
  29. cardA
  30. czechD
  31. czech
  32. (CreditA
  33. (Credit
  34. Number)A
  35. (CzechD
  36. (Czech
  37. Personal
  38. (SocialB
  39. (Social
  40. Insurance
  41. Number)C
  42. (Social
  43. Security
  44. Number)B
  45. CardA
  46. InsuranceC
  47. ValidationE
  48. Number)A
  49. PersonalD
  50. SecurityB
  51. ValidationE
  52. Quarter
  53. 2nd Quarter
  54. 3rd Quarter
  55. 4th Quarter
  56. safe access
  57. text fieldf
  58. 0g    uncheckedu
  59. CREDIT_CARDv
  60. (Credit Card Number)y
  61. xxxx xxxx xxxx xxxx
  62. password fieldf
  63. checkedu
  64. (Social Security Number)y
  65. xxx-xx-xxxx
  66. checkboxf
  67. mixedu
  68. (Social Insurance Number)y
  69. xxx-xxx-xxx
  70. radio buttonu
  71. CZECH_IDv
  72. (Czech Personal ID)y
  73. xxxxxx/xxxx
  74. pop-up menuv
  75. No Validation
  76. 9/5/02
  77. BUTTONPRESSED
  78. DLOGBUTTON1
  79. DLOGBUTTON2
  80. DLOGBUTTON3
  81. DLOGBUTTON4
  82. DLOGBUTTON5
  83.     DLOGERROR
  84. DLOGERRORDESC
  85. DLOGERRORMSG
  86. DLOGEXPERT
  87. DLOGFIELD1
  88. DLOGFIELD2
  89. DLOGFIELD3
  90. DLOGFIELD4
  91. DLOGFIELD5
  92. DLOGFIELDFORMAT
  93. DLOGMESSAGE
  94. ,    DLOGNAME1
  95. )    DLOGNAME2
  96. *    DLOGNAME3
  97. +    DLOGPOPUP
  98. DLOGPROMPT
  99.     DLOGTYPE1
  100.     DLOGTYPE2
  101.     DLOGTYPE3
  102. DLOGVALUE1
  103. DLOGVALUE2
  104. DLOGVALUE3
  105. GLOGWITHVALIDATION
  106. TEXTDELIMITER
  107. TEXTENTERED
  108. TEXTENTEREDALL
  109. 2    TEXTINDEX
  110. /    VERPARAM2
  111.     VERRESULT
  112. VERSION
  113. VLSTCHECKSTATE
  114. VLSTFIELDTYPE
  115. VLSTFORMATDESC
  116. VLSTFORMATTEMPLATE
  117. VLSTFORMATTYPE
  118. vlstFormatTemplateB
  119. ogButton2V
  120. dlogButton3X
  121. dlogButton4Z
  122. dlogButton5\
  123. dlogField1^
  124. dlogField2`
  125. dlogField3b
  126. dlogField4d
  127. dlogField5f
  128. dlogMessageh    dlogName1j    dlogName2l    dlogName3n    dlogType1p    dlogType2r    dlogType3t
  129. dlogValue1v
  130. dlogValue2x
  131. dlogValue3z
  132. vlstFieldType|
  133. vlstTypeDesc~
  134. vlstCheckState
  135. vlstStateDesc
  136. vlstFormatType
  137. vlstFormatDesc
  138. dlogExpert
  139. dlogErrorMsg
  140. J    textIndex
  141. textDelimiter
  142. textEntered
  143. textEnteredAll
  144. buttonPressed
  145. T    dlogPopup
  146. A>I am the simplest dynamic dialog ever made with FileMaker Pro.
  147. SecondV
  148. ThirdW
  149. FourthX
  150. FifthY
  151. FirstZ
  152. Second[
  153. Third\
  154. Fourth]
  155. Fifth^
  156. guestb
  157. guestc
  158. Usernamej
  159. Passwordk
  160. Remember passwordl9Please enter your username and password to see the magic:m&Message|c:Red&c:Green&c:Blue|OK&Cancelo
  161. , t$Red
  162. Green
  163. Magenta
  164. Yelloww
  165. CREDIT_CARD
  166. Welcome
  167. Version
  168. Showing a dialog 1
  169. Register
  170. Showing a dialog 2
  171. Showing a dialog 3
  172. Showing a dialog 4
  173. Showing a dialog 5
  174. Getting information
  175. Showing a dialog 6
  176. Showing a dialog 7
  177. howing a dialog 7
  178. WelcomeB
  179. dlogButton4B
  180. dlogButton5B
  181. dlogField1B
  182. dlogField2B
  183. dlogField3B
  184. dlogField4B
  185. dlogField5B
  186. A    dlogType1B
  187. A    dlogType2B
  188.  A    dlogType3B
  189. dlogValue1B
  190. dlogValue2B
  191. dlogValue3B
  192. vlstFieldTypeB
  193. vlstTypeDescB
  194. vlstCheckStateB
  195. vlstStateDesc
  196. dlogErrorDescB
  197.  = "0"
  198.  "No error"
  199.  = "-1"
  200.  "Missing symbol"
  201.  = "-2"
  202.  "Unexpected end of definition"
  203.  = "-50"
  204.  "Internal parameter error"
  205.  = "-108"
  206.  "Not enough memory"
  207.  = "-1700"
  208.  "Definition syntax error"
  209.  "Unknown error")
  210. No error
  211. Missing symbol
  212. Unexpected end of definition
  213. Internal parameter error
  214. Not enough memory
  215. -1700
  216. Definition syntax error
  217. Unknown error 
  218. )A    dlogName1B
  219. *A    dlogName2B
  220. +A    dlogName3B
  221. dlogMessageB
  222. dlogExpertB
  223. dlogErrorMsgB
  224. /A    textIndexB
  225. textDelimiterB
  226. textEnteredB
  227. |("24uD-TextEntered"
  228. 24uD-TextEntered
  229. textEnteredAllB
  230. |("24uD-AllTextEntered"
  231. 24uD-AllTextEntered
  232. buttonPressedB
  233. |("24uD-ButtonPressed"
  234. 24uD-ButtonPressed
  235. 4A    dlogPopupB
  236. vlstFormatTypeB
  237. vlstFormatDescB
  238. dlogFieldFormatB
  239. glogWithValidationB
  240. "Please enter " &
  241.  "anything"
  242.  "your " & 
  243. 6) - 2)) &
  244. ":|t::{" & 
  245. 7 & "}" &
  246. VersionB
  247. "Welcome to the 24U SimpleDialog Plug-In tutorial!
  248. This tutorial will teach you how to use the functions provided by 24U SimpleDialog Plug-In to display standard types of dialogs, as well as completely custom ones.
  249. This version of 24U SimpleDialog Plug-In offers the following 6 functions:
  250. AP24uD-Version    returns version of the 24U SimpleDialog Plug-In currently installed
  251. AE24uD-ShowDialog    displays a modal dialog based on the second parameter
  252. AN24uD-ButtonPressed    returns the number of the button clicked in the last dialog
  253. AW24uD-TextEntered    returns the value of the dialog item specified by the second parameter
  254. AV24uD-AllTextEntered    returns the values of all items, separated by the second parameter
  255.     AR24uD-Register    allows you to enter registration code to turn off shareware reminder
  256. To learn about how these functions let you display dialogs of your own, please click on the Next button, which will bring you to the step-by-step instructions.L
  257. NextM.Copyright 
  258. 2001-2002 24U. All rights reserved.
  259. Showing a dialog 1B
  260. SimpleDialog Plug-In <<
  261. ABAB>>
  262. NChecking current version of 24U SimpleDialog Plug-In
  263. This function returns either short or long version string of the plug-in currently installed. To get the short version string, provide an empty string as a second parameter. To get the long version string, you can use anything else, however we recommend you use the 
  264.  string.
  265. You can (and should) use this function to check if your solution is really using the version of 24U SimpleDialog Plug-In which you used to build it.L
  266. NextP
  267. paramS
  268. External("24uD-Version", param)T
  269. PreviousU
  270. RegisterB
  271. SimpleDialog Plug-In <<
  272. ABAB>>
  273. SimpleDialog Plug-In <<
  274. ABAB>>
  275. Displaying a dialog - part 1 - just a text message
  276. The best thing on the 24U SimpleDialog Plug-In is that using it is as simple as the dialogs you want to show....
  277. KNTo display a dialog with the prompt entered above, use the following function:L
  278. NextP
  279. promptS#External("24uD-ShowDialog", prompt)T
  280. PreviousU
  281. Home_
  282. Try it
  283. Unlocking 24U SimpleDialog Plug-In with a registration code
  284. As you keep testing this plug-in, you will notice that a shareware reminder appears periodically on your screen. That's OK for testing but not for regular use or even for the solutions that your customers will be using.
  285. To disable the shareware reminder, assuming you paid for your licence and obtained an unlock code from 24U, you must call the 24uD-Register function with the unclock code right after your file opens. The best wayB
  286.  to achieve this is to create the following script and select it as a startup script in the Document Preferences, or call it at the beginning of your own startup script.
  287. NextT
  288. PreviousU
  289. HomeYdIf ["External("24uD-Register", "your unlock code here")"]
  290.   Comments ["Invalid unlock code"]
  291. End If
  292. Showing a dialog 2ialog 2
  293.  dop.
  294.  odp.
  295. SimpleDialog Plug-In <<
  296. ABAB>>
  297. Displaying a dialog - part 2 - adding custom buttons
  298. You can also define up to 5 buttons for the dialog, just like you can define up to three in the Show Message script step...
  299. KUTo display a dialog with the buttons defined on the left, use the following function:L
  300. NextP
  301. promptT
  302. PreviousU
  303. Home_
  304. Try itd
  305. button1f
  306. button2g
  307. button3h
  308. button4i
  309. button5k{External("24uD-ShowDialog", prompt & "<<
  310. ABBE>>" & button1 & "&" & button2 & "&" & button3 & "&" & button4 & "&" & button5)
  311. 0A/Tip: Try leaving the first button name empty...
  312. Showing a dialog 3B
  313. SimpleDialog Plug-In <<
  314. ABAB>>
  315. Displaying a dialog - part 3 - adding text fields
  316. If you need text fields, you can add them simply the same way you would add buttons, just omit one of the vertical lines used as separators...
  317. KUTo display a dialog with the buttons defined on the left, use the following function:L
  318. NextP
  319. promptT
  320. PreviousU
  321. Home_
  322. Try itd
  323. field1f
  324. field2g
  325. field3h
  326. field4i
  327. field5knExternal("24uD-ShowDialog", prompt & "|" & field1 & "&" & field2 & "&" & field3 & "&" & field4 & "&" & field5)
  328. 0A,Tip: You are not limited to only 5 fields...
  329. Showing a dialog 4B
  330. SimpleDialog Plug-In <<
  331. ABAB>>
  332. Displaying a dialog - part 4 - fully customizable dialog
  333. Finally, you can mix different kinds of dialog items in a single dialog, and you can specify their default values as well. And you can have up to ten input items in one dialog...
  334. SimpleDialog Plug-In <<
  335. ABAB>>
  336. Displaying a dialog - part 4 - fully customizable dialog
  337. Finally, you can mix different kinds of dialog items in a single dialog, and you can specify their default values as well. And you can have up to ten input items in one dialog...
  338. messageT
  339. PreviousU
  340. Home_
  341. Try itd
  342. field1
  343. field2g
  344. field3
  345. names
  346. typet
  347. text/password
  348. check/radio
  349. result
  350. Showing a dialog 5B
  351.  dop.
  352.  odp.
  353. SimpleDialog Plug-In <<
  354. ABAB>>
  355. AlDisplaying a dialog - part 5 - general syntax
  356. The syntax you use to define your dialogs is really simple...
  357. The functionL
  358. NextT
  359. PreviousU
  360. Home_
  361. Try itk'External("24uD-ShowDialog", definition)
  362. definition~(= message & "|" & fields &
  363. "|" & buttons
  364. message
  365. = any text
  366. fields
  367. B/= field 1 & "&" & field 2 & ... & "&" & field n
  368. buttons
  369. D2= button 1 & "&" & button 2 & ... & "&" & button n
  370. field n
  371. G)= type &
  372. ":" & name &
  373. ":" & default value
  374. ABCO>>
  375. Example:
  376. Getting informationB
  377.  dop.
  378.  odp.
  379. SimpleDialog Plug-In <<
  380. ABAB>>
  381. Getting information entered into the last dialog
  382. There is nothing new about getting information from 24U SimpleDialog. Simply use the techniques you use every day with Status(CurrentMessageChoice) and GetRepetition...
  383. NextT
  384. PreviousU
  385. Home_
  386. Displayk"External("24uD-ButtonPressed", "")
  387. ABCO>>
  388. O-1. Display the dialog and enter values in it:
  389. PT2. Gather the data (note that empty fields are not returned by 24uD-AllTextEntered):
  390. External("24uD-TextEntered", "
  391. V!External("24uD-AllTextEntered", "
  392. Showing a dialog 6B
  393. SimpleDialog Plug-In <<
  394. ABAB>>
  395. Displaying a dialog - part 6 - pop-up menus (new in version 1.0.1)
  396. Starting with version 1.0.1 you can add also pop-up menus to your dialogs. Use the following syntax to define a pop-up menu field:
  397. NextT
  398. PreviousU
  399. Home_
  400. Try it
  401. popup field
  402. G3= "m" &
  403. ":" & name &
  404. ":" & values [&
  405. ":" & default]
  406. Sample value list:
  407. values
  408. M/= value 1 & "
  409. " & value 2 & ... & "
  410. " & value n
  411. Showing a dialog 7B
  412. Shutdown
  413. Show Dialog 1
  414. |("24uD-ShowDialog"
  415. 24uD-ShowDialog
  416. Show Dialog 2
  417. |("24uD-ShowDialog"
  418.  & "||" & 
  419.  & "&" & 
  420.  & "&" & 
  421.  & "&" & 
  422.  & "&" & 
  423. 24uD-ShowDialog
  424. Show Dialog 3
  425. Invalid unlock codeC1
  426. )) = 1    
  427. |("24uD-ShowDialog"
  428.  "With 24U SimpleDialog Plug-In, your FileMaker Pro solutions can display dialogs with all these cool custom items:" & "|Text fields:Well, not so new but
  429. &p:Passwords:hiddenofcourse&c:Check boxes:1&c:Even with mixed state:2&" & "m:Pop-up menus:From version 1.0.1&r:Radio buttons&r:Of course, only one selected&Text fields:
  430. it was never so flexible,
  431. and so easy to use.|COOL!&so&is&This&Whoa!")
  432. 24uD-ShowDialog
  433. qWith 24U SimpleDialog Plug-In, your F
  434. `ileMaker Pro solutions can display dialogs with all these cool custom items:
  435. h|Text fields:Well, not so new but
  436. &p:Passwords:hiddenofcourse&c:Check boxes:1&c:Even with mixed state:2&
  437. m:Pop-up menus:From version 1.0.1&r:Radio buttons&r:Of course, only one selected&Text fields:
  438. it was never so flexible,
  439. and so easy to use.|COOL!&so&is&This&Whoa!
  440. |("24uD-ShowDialog"
  441.  "With 24U SimpleDialog Plug-In, your FileMaker Pro solutions can display dialogs with all these cool custom items:" & "|Text fields:Well, not so new but...&p:Passwords:hiddenofcourse&c:Check boxes:1&m:Pop-up menus:From version 1.0.1&r:Radio buttons&r:Of course, only one selected&Text fields:...it was never so flexible,...&:...and so easy to use.|COOL!&so&is&This&Whoa!")
  442. 24uD-ShowDialog
  443. qWith 24U SimpleDialog Plug-In, your FileMaker Pro solutions 
  444. 4can display dialogs with all these cool custom items:
  445. |Text fields:Well, not so new but...&p:Passwords:hiddenofcourse&c:Check boxes:1&m:Pop-up menus:From version 1.0.1&r:Radio buttons&r:Of course, only one selected&Text fields:...it was never so flexible,...&:...and so easy to use.|COOL!&so&is&This&Whoa!
  446. Show Dialog 4
  447. |("24uD-ShowDialog"
  448. , & "|" & 
  449.  & ":"
  450.  ":" & 
  451.  & "&" & 
  452.  & ":"
  453.  ":" & 
  454.  & "&" & 
  455.   & ":"
  456.  ":" & 
  457. 24uD-ShowDialog
  458. Show Dialog 5
  459. |("24uD-ShowDialog"
  460. 24uD-ShowDialog
  461. |("24uD-ShowDialog"
  462.  & "|" & 
  463.  & "&" & 
  464.  & "&" & 
  465.  & "&" & 
  466.  & "&" & 
  467. 24uD-ShowDialog
  468. Ei>_B
  469. Startup Wow Dialog
  470. )) = 1    
  471. |("24uD-ShowDialog"
  472.  "With 24U SimpleDialog Plug-In, your FileMaker Pro solutions can display dialogs with all these cool custom items:" & "|Text fields:Well, not so new but
  473. &p:Passwords:hiddenofcourse&c:Check boxes:1&c:Even with mixed state:2&" & "m:Pop-up menus:From version 1.0.1&r:Radio buttons&r:Of course, only one selected&Text fields:
  474. it was never so flexible,
  475. and so easy to use.|COOL!&so&is&This&Whoa!")
  476. 24uD-ShowDialog
  477. qWith 24U SimpleDialog Plug-In, your F
  478. Show Dialog 6
  479. |("24uD-ShowDialog"
  480.  "This is an example of a pop-up menu dialog.|m:Your menu:" & 
  481. 4 & ":1|OK")
  482. 24uD-ShowDialog
  483. 8This is an example of a pop-up menu dialog.|m:Your menu:
  484. :1|OK
  485. Getting Full Access
  486. )) = 2    
  487.     Thank youF 
  488. Cancel
  489. To get full access to this file, open it while holding the Shift key on your keyboard, and type "full access" as your password.
  490. `ileMaker Pro solutions can display dialogs with all these cool custom items:
  491. h|Text fields:Well, not so new but
  492. &p:Passwords:hiddenofcourse&c:Check boxes:1&c:Even with mixed state:2&
  493. m:Pop-up menus:From version 1.0.1&r:Radio buttons&r:Of course, only one selected&Text fields:
  494. it was never so flexible,
  495. and so easy to use.|COOL!&so&is&This&Whoa!
  496. |("24uD-ShowDialog"
  497.  "With 24U SimpleDialog Plug-In, your FileMaker Pro solutions can display dialogs with all these cool custom items:" & "|Text fields:Well, not so new but...&p:Passwords:hiddenofcourse&c:Check boxes:1&m:Pop-up menus:From version 1.0.1&r:Radio buttons&r:Of course, only one selected&Text fields:...it was never so flexible,...&:...and so easy to use.|COOL!&so&is&This&Whoa!")
  498. 24uD-ShowDialog
  499. qWith 24U SimpleDialog Plug-In, your FileMaker Pro solutions 
  500. 4can display dialogs with all these cool custom items:
  501. |Text fields:Well, not so new but...&p:Passwords:hiddenofcourse&c:Check boxes:1&m:Pop-up menus:From version 1.0.1&r:Radio buttons&r:Of course, only one selected&Text fields:...it was never so flexible,...&:...and so easy to use.|COOL!&so&is&This&Whoa!
  502. Show Dialog 7
  503. |("24uD-ShowDialog"
  504. 24uD-ShowDialog
  505. is an example of a pop-up menu dialog.|m:Your menu:
  506. :1|OK
  507. Startup
  508. Shutdown
  509. Show Dialog 1
  510. Show Dialog 2
  511. Show Dialog 3
  512. Show Dialog 4
  513. Show Dialog 5
  514. Show Dialog 6
  515. Show Dialog 7
  516. Startup Wow Dialog
  517. Getting Full Access
  518. Startup
  519. |("24uD-Register"
  520.  "your unlock code here")
  521. 24uD-Register
  522. your unlock code here|
  523. ARPTH
  524. FPTHAAWork HD:Projects:24U Transcoding Plug-In:Development:charsets.fp3
  525. MSPCA
  526. NAMEA
  527. charsets.fp3
  528. RPTHA
  529. charsets.fp3
  530. Work HD
  531. charsets.fp3
  532. 2$+FMP3FMP3
  533. Development
  534. AWork HD:Projects:24U Transcoding Plug-In:Development:charsets.fp3
  535. (LIST
  536. LISTA
  537. VDEFA(
  538. (LIST
  539. VDEFA(
  540. (LIST
  541. VDEFA(
  542. field typesC
  543. checked statesD
  544. field formats
  545. FMRLA
  546.     Helvetica
  547. Geneva
  548. Courier
  549. Helvetica CE
  550. Arial
  551. MS Sans Serif
  552. Pro 3.0 - 4.0F!
  553. tvrtek
  554. sobota
  555. ledna
  556. dubna
  557. ervna
  558. ervence
  559. srpna
  560.     listopadu
  561. prosince
  562. 1st Quarter
  563. 2nd Quarter
  564. 3rd Quarter
  565. 4th Quarter
  566. safe access
  567. SimpleDialog Plug-In <<
  568. ABAB>>
  569. SimpleDialog Plug-In <<
  570. ABAB>>
  571.     Thank youF 
  572. Cancel
  573. To get full access to this file, open it while holding the Option key on your keyboard, and type "full access" as your password.
  574. WelcomeB
  575. Layout #12B
  576. SimpleDialog Plug-In <<
  577. ABAB>>
  578. Displaying a dialog - part 6 - text field validation (new in version 1.1)
  579. Starting with version 1.1 you can specify validations for your text and password fields.
  580. To use a validation, precede the text field's default value with a special format specifier:
  581. SimpleDialog Plug-In <<
  582. ABAB>>
  583. Displaying a dialog - part 6 - pop-up menus (new in version 1.0.1)
  584. Starting with version 1.0.1 you can add also pop-up menus to your dialogs. Use the following syntax to define a pop-up menu field:
  585. NextT
  586. PreviousU
  587. Home_
  588. Try it
  589. format specifier
  590. G,= "{" &
  591. format name [&
  592. format options] & "}"
  593. Sample dialog with validation:
  594. format name
  595. X(External("24uD-ShowDialog", "<<
  596. ABDI>>")
  597. [/no additional options available for this format
  598. VLSTSTATEDESC
  599. VLSTTYPEDESC
  600. versionB
  601. |("24uD-Version"
  602.  "") = ""
  603.  "not installed"
  604. |("24uD-Version"
  605.  ""))
  606. 24uD-Version
  607. not installed
  608. 24uD-Version
  609. A    verParam2B
  610. A    verResultB
  611. |("24uD-Version"
  612. 24uD-Version
  613. dlogPromptB
  614. A    dlogErrorB
  615. dlogButton1B
  616. dlogButton2B
  617. dlogButton3B
  618. password fieldf
  619. checkedu
  620. (Social Security Number)y
  621. xxx-xx-xxxx
  622. checkboxf
  623. mixedu
  624. (Social Insurance Number)y
  625. xxx-xxx-xxx
  626. radio buttonu
  627. CZECH_IDv
  628. (Czech Personal ID)y
  629. xxxxxx/xxxx
  630. pop-up menuv
  631. No Validation
  632. Please enter 
  633. anything
  634. your 
  635. :|t::{
  636.  & "}" &
  637. "xxxx" &
  638. "Please enter 
  639.     anything:
  640. your 
  641. :|t::{
  642. FieldFormat
  643. FMRLA
  644. FormatDesc
  645. FMRLA
  646. 1.1.1
  647. 24U SimpleDialog Plug-In 1.1.1
  648. 1.1.1
  649. 1.1.1 
  650. Copyright 
  651. 2001-2002 24U
  652. >SORT
  653.